package com.loeng.module.infra.service.logger;

import com.loeng.framework.common.pojo.PageResult;
import com.loeng.module.infra.api.logger.dto.ApiAccessLogCreateReqDTO;
import com.loeng.module.infra.controller.admin.logger.vo.apiaccesslog.ApiAccessLogPageReqVO;
import com.loeng.module.infra.controller.admin.logger.vo.apiaccesslog.ApiAccessLogSaveReqVO;
import com.loeng.module.infra.dal.dataobject.logger.ApiAccessLogDO;

import javax.validation.Valid;

/**
 * API 访问日志 Service 接口
 *
 * @author loeng zhuo
 */
public interface ApiAccessLogService {

    /**
     * 创建API 访问日志
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createApiAccessLog(@Valid ApiAccessLogSaveReqVO createReqVO);

    /**
     * 更新API 访问日志
     *
     * @param updateReqVO 更新信息
     */
    void updateApiAccessLog(@Valid ApiAccessLogSaveReqVO updateReqVO);

    /**
     * 删除API 访问日志
     *
     * @param id 编号
     */
    void deleteApiAccessLog(Long id);

    /**
     * 获得API 访问日志
     *
     * @param id 编号
     * @return API 访问日志
     */
    ApiAccessLogDO getApiAccessLog(Long id);

    /**
     * 获得API 访问日志分页
     *
     * @param pageReqVO 分页查询
     * @return API 访问日志分页
     */
    PageResult<ApiAccessLogDO> getApiAccessLogPage(ApiAccessLogPageReqVO pageReqVO);

    /**
     * 创建 API 访问日志
     *
     * @param createReqDTO API 访问日志
     */
    void createApiAccessLog(ApiAccessLogCreateReqDTO createReqDTO);

}
